HitTest Method

The HitTest method returns the graphics elements at a specific location or within a defined box.

Example

The MouseDownDeleteRight function uses a mouse event function to define the mouse button action.

FUNCTION MOUSEDOWNDELETERIGHT, Window, $

X, Y, Button, KeyMods, Clicks

 

PRINT, 'MouseDownHandler'

HELP, Window, $

   X, Y, Button, KeyMods, Clicks

 

IF Button EQ 4 THEN BEGIN

  oVisList = Window.HitTest(X, Y)

  FOREACH vis, oVisList DO BEGIN

    vis.Delete

  ENDFOREACH

  RETURN, 0 ; Skip default event handling

ENDIF ELSE RETURN, 1 ; Perform default event handling

 

END

The DeleteRight routine creates a graphic with text areas to test the MouseDownDeleteRight function.

PRO DELETERIGHT

; Delete a graphic if the user right-clicks on it

p=plot(/test)

t1=text(.5, .8, 'Text 1')

t2=text(.5, .5, 'Text 2')

p.window.MOUSE_DOWN_HANDLER='MouseDownDeleteRight'

 

HELP, p, t1, t2

 

END

Syntax

Result = graphic.HitTest(X, Y, [DIMENSIONS=dimensions])

Return Value

The HitTest method returns an array of graphics items at a specified location or within a box specified by dimensions. Use the returned references to manipulate the graphics.

Arguments

X

The X location, in device coordinates, to use for the hit test.

Y

The Y location, in device coordinates, to use for the hit test.

Keywords

DIMENSIONS

A two element vector [X,Y] containing the dimensions of a box centered on X, Y to use for the hit test.

Version History

8.1	Introduced

See Also

Select Method, Using IDL Graphics